configure log target severity

configure log target [console | memory-buffer | nvram |primary-node |backup-node | session | syslog [all | ipaddress {udp-port {udp_port}} | ipPort | ipaddress tls-port {tls_port} ] {vr vr_name} {local0...local7 }] {severity severity {only}}

Description

Sets the severity level of messages sent to the target.

In a stack, this command is applicable only to Master and Backup nodes. You cannot run this command on standby nodes.

Syntax Description

console Specifies the console display.
memory-buffer Specifies the switch memory buffer.
nvram Specifies the switch NVRAM.
primary-node Specifies the primary node in a stack.
backup-node Specifies the backup node in a stack.
session Specifies the current session (including console display).
syslog Specifies a syslog target.
all Specifies all of the remote syslog servers.
ipaddress Specifies the syslog IP address.
ipPort Specifies the UDP port number for the syslog target.
vr_name

Specifies the virtual router that can reach the server IP address.

Note: User-created VRs are supported only on the platforms listed for this feature in the Switch Engine v33.1.1 Licensing Guide document.
local0 ... local7 Specifies the local syslog facility.
severity Specifies the least severe level to send (if the keyword only is omitted).
only Specifies that only the specified severity level is to be sent.

Default

By default, targets are sent messages of the following severity level and above:
  • console display—info
  • memory buffer—debug-data
  • NVRAM—warning
  • session—info
  • syslog—debug-data
  • primary node—warning (stack only)
  • backup node—warning (stack only)

If a virtual router is not specified, VR-Mgmt is used.

Usage Guidelines

This command configures the specified target with a severity level. The filter associated with the target is not affected. A message is sent to a target if the target has been enabled, the message passes the associated filter, the message is at least as severe as the configured severity level, and the message output matches the regular expression specified.

See the command show log for a detailed description of severity levels.

To see the current configuration of a target, use the following command:

show log configuration target {console | memory-buffer | nvram | primary-node | backup-node | session | syslog {ipaddress {udp-port {udp_port }}| ipPort |ipaddress tls-port {tls_port}} {vr vr_name} {[local0...local7]}}

To see the current configuration of a filter, use the following command:

show log configuration filter {filter name}

Example

The following command sends log messages to the current session, that pass the current filter at a severity level of info or greater, and contain the string user5:

configure log target session severity info

History

This command was first available in ExtremeXOS 10.1.

The ipPort parameter was first available in ExtremeXOS 11.1.

The udp-port parameter was added in ExtremeXOS 21.1.

Platform Availability

This command is available on all Universal switches supported in this document.